<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<META NAME="generator" CONTENT="http://txt2tags.org">
</HEAD><BODY BGCOLOR="white" TEXT="black">
<CENTER>
</CENTER>


<H2>Items: Prefixed by colon</H2>

<DL>
<DT>Use the colon to prefix list items.</DT><DD>
<DT>There must be one space after the colon.</DT><DD>
<DT>The list is closed by two consecutive blank lines.</DT><DD>
</DL>

<H2>Items: Free leading spacing (indentation)</H2>

     <DL>
     <DT>The list can be indented on the source document.</DT><DD>
     <DT>You can use any number of spaces.</DT><DD>
     <DT>The result will be the same.</DT><DD>
     </DL>

<H2>Items: Vertical spacing between items</H2>

<DL>
<DT>Let one blank line between the list items.</DT><DD>
<P></P>
<DT>It will be maintained on the conversion.</DT><DD>
<P></P>
<DT>Some targets don't support this behavior.</DT><DD>
<P></P>
<DT>This one was separated by a line with blanks.</DT><DD>
  You can also put a blank line inside
<P></P>
  the item contents and it will be preserved.
</DL>

<H2>Items: Exactly ONE space after the colon</H2>

<P>
:This is not a list (no space)
</P>

<DL>
<DT>   This is not a list (more than one space)</DT><DD>
<P></P>
:	This is not a list (a TAB instead the space)
</DL>

<H2>Items: Catchy cases</H2>

<DL>
<DT>- This is a list</DT><DD>
<DT>+ This is a list</DT><DD>
<DT>: This is a list</DT><DD>
</DL>

<H2>Nesting: Creating sublists</H2>

<DL>
<DT>This is the "mother" list first item.</DT><DD>
<DT>Here is the second, but inside this item,</DT><DD>
  <DL>
  <DT>there is a sublist, with its own items.</DT><DD>
  <DT>Note that the items of the same sublist</DT><DD>
  <DT>must have the same indentation.</DT><DD>
    <DL>
    <DT>And this can go on, opening sublists.</DT><DD>
      <DL>
      <DT>Just add leading spaces before the</DT><DD>
      <DT>colon and sublists will be opened.</DT><DD>
      <DT>The two blank lines closes them all.</DT><DD>
      </DL>
    </DL>
  </DL>
</DL>

<H2>Nesting: Free leading spacing (indentation)</H2>

<DL>
<DT>When nesting lists, the additional spaces are free.</DT><DD>
 <DL>
 <DT>You can add just one,</DT><DD>
        <DL>
        <DT>or many.</DT><DD>
          <DL>
          <DT>What matters is to put more than the previous.</DT><DD>
          <DT>But remember that the other items of the same list</DT><DD>
          <DT>must use the same indentation.</DT><DD>
          </DL>
        </DL>
 </DL>
</DL>

<H2>Nesting: Maximum depth</H2>

<DL>
<DT>There is not a depth limit,</DT><DD>
  <DL>
  <DT>you can go deeper and deeper.</DT><DD>
    <DL>
    <DT>But some targets may have restrictions.</DT><DD>
      <DL>
      <DT>The LaTeX maximum is here, 4 levels.</DT><DD>
        <DL>
        <DT>This one and the following sublists</DT><DD>
          <DL>
          <DT>are moved up to the level 4</DT><DD>
            <DL>
            <DT>when converting to LaTeX.</DT><DD>
              <DL>
              <DT>On the other targets,</DT><DD>
                <DL>
                <DT>it is just fine</DT><DD>
                  <DL>
                  <DT>to have a very deep list.</DT><DD>
                  </DL>
                </DL>
              </DL>
            </DL>
          </DL>
        </DL>
      </DL>
    </DL>
  </DL>
</DL>

<H2>Nesting: Reverse doesn't work</H2>

        <DL>
        <DT>Reverse nesting doesn't work.</DT><DD>
        </DL>

      <DL>
      <DT>Because a sublist *must* have a mother list.</DT><DD>
      </DL>

    <DL>
    <DT>It's the list concept, not a txt2tags limitation.</DT><DD>
    </DL>

  <DL>
  <DT>All this sublists will be bumped to mother lists.</DT><DD>
  </DL>

<DL>
<DT>At level 1, like this one.</DT><DD>
</DL>

<H2>Nesting: Going deeper and back</H2>

<DL>
<DT>Level 1</DT><DD>
  <DL>
  <DT>Level 2</DT><DD>
    <DL>
    <DT>Level 3</DT><DD>
      <DL>
      <DT>Level 4</DT><DD>
      </DL>
    <DT>Level 3 -- (closed Level 4)</DT><DD>
    </DL>
  <DT>Level 2 -- (closed Level 3)</DT><DD>
  </DL>
<DT>Level 1 -- (closed Level 2)</DT><DD>
</DL>

<DL>
<DT>Level 1</DT><DD>
  <DL>
  <DT>Level 2</DT><DD>
    <DL>
    <DT>Level 3</DT><DD>
      <DL>
      <DT>Level 4</DT><DD>
      </DL>
    </DL>
  </DL>
<DT>Level 1 -- (closed Level 4, Level 3 and Level 2)</DT><DD>
</DL>

<H2>Nesting: Vertical spacing between lists</H2>

<DL>
<DT>Level 1</DT><DD>
<P></P>
  <DL>
  <DT>Level 2 -- blank BEFORE and AFTER (in)</DT><DD>
  <P></P>
    <DL>
    <DT>Level 3</DT><DD>
      <DL>
      <DT>Level 4</DT><DD>
      </DL>
    <DT>Level 3</DT><DD>
    <P></P>
    </DL>
  <DT>Level 2 -- blank BEFORE and AFTER (out)</DT><DD>
  <P></P>
  </DL>
<DT>Level 1</DT><DD>
<P></P>
  <DL>
  <DT>Level 2 -- blank BEFORE (spaces) and AFTER (TAB)</DT><DD>
  <P></P>
    <DL>
    <DT>Level 3</DT><DD>
    </DL>
  </DL>
</DL>

<H2>Nesting: Messing up</H2>

<DL>
<DT>Level 1</DT><DD>
    <DL>
    <DT>Level 2</DT><DD>
        <DL>
        <DT>Level 3</DT><DD>
            <DL>
            <DT>Level 4</DT><DD>
            </DL>
        <DT>Level 3.5 ???</DT><DD>
        <DT>Level 3</DT><DD>
        </DL>
    <DT>Level 2.5 ???</DT><DD>
    <DT>Level 2</DT><DD>
    </DL>
<DT>Level 1.5 ???</DT><DD>
<DT>Level 1</DT><DD>
</DL>

<H2>Closing: Two (not so) empty lines</H2>

<DL>
<DT>This list is closed by a line with spaces and other with TABs</DT><DD>
</DL>

<DL>
<DT>This list is NOT closed by two comment lines</DT><DD>
<DT>This list is closed by a line with spaces and TAB,</DT><DD>
<DT>then a comment line, then an empty line.</DT><DD>
</DL>

<H2>Closing: Empty item closes current (sub)list</H2>

<DL>
<DT>Level 1</DT><DD>
  <DL>
  <DT>Level 2</DT><DD>
    <DL>
    <DT>Level 3</DT><DD>
    </DL>
    Level 2
  </DL>
  Level 1
</DL>

<DL>
<DT>Empty item with trailing spaces.</DT><DD>
</DL>

<DL>
<DT>Empty item with trailing TAB.</DT><DD>
</DL>

<H2>Closing: EOF closes the lists</H2>

<DL>
<DT>If the end of the file (EOF) is hit,</DT><DD>
  <DL>
  <DT>all the currently opened list are closed,</DT><DD>
    <DL>
    <DT>just like when using the two blank lines.</DT><DD>
    </DL>
  </DL>
</DL>

<!-- html code generated by txt2tags (http://txt2tags.org) -->
<!-- cmdline: txt2tags -q -\-no-rc -C config -o deflist.html list.t2t -->
</BODY></HTML>
